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A communication system for monitoring and/or controlling communication parameters of a remote communication device. The 
communication system monitors a communication channel that is created between the remote communication device and controls 
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INTERNATIONAL APPLICATION 
UNDER THE PATENT COOPERATION TREATY 

(Attorney Docket No.: 98RSS027PCT) 



TITLE: Method and Apparatus for Monitoring, Controlling, and 

Configuring Remote Communication Devices 

10 A portion of the disclosure of the patent document contains material which is subject 

to copyright protection. The copyright owner has no objection to the facsimile reproduction 
by any-one of the patent document or the patent disclosure, as ^ appears in the publication of 
the International Application, but otherwise reserves all copyright rights whatsoever. 
1. Technical Field 

is The present invention relates to communication systems and more particularly to a 

computer communication system that, among other tilings, monitors, controls, and diagnoses 
inefficiencies in communication parameters of the computer communication system while one 
computer system communicates with another computer system. 

20 2. Background Art 

In traditional implementations, control and monitoring of computer communication 
systems primarily concern monitoring and controlling internal parameters of modems and are 
performed through the use of modem control strings such as "AT commands". AT commands 
require a user to switch the modem from data to command mode so that the modem can be 

25 controlled with AT commands. Thus, AT commands interfere with the typical data flow of the 
modem and the commands do not reflect the true state of the modem in real time. Of note, in 
some traditional hardware modem implementations, limited control and status monitoring 
capabilities are obtained through adding special non-standard hardware interfaces. However, 
these special hardware interfaces are a relatively expensive solution to the problem of real time 

30 modem monitoring and the usage is limited due to its complexity. 

l 



SOOCID: <WO_994Se95A1_)_> 



WO 99/45695 



PCT/US99/04841 



If the user chooses not to add the additional network equipment to retrieve the modem 
information, the user is forced to rely on verbal guidance from another person, such as a support 
technician, located at a second modem site. This support technician views the parameters of the 
modem connection from their end of the connection, performs a modem diagnosis based on 
5 available resources, and reports configuration options to the user for manual modem control and 
monitoring. Clearly, this process for modem monitoring and control is unsatisfactory because, 
among other things, the process requires detailed and easily misunderstood verbal instructions 
for modem configuration, the process requires the modem to be switched from data to command 
mode to enter the diagnostic commands for modem configuration, and at least two people are 
10 required to diagnose and configure a single modem. Thus, the monitor and configuration 
process is time consuming and frustrating for those involved. 

Of current interest is a computer communication system that overcomes the 
disadvantages of the related art. Among other advantages and benefits, the computer 
communication system according to the principles of the present invention monitors, controls, 
is and diagnoses inefficiencies in communication parameters of the computer communication 
system while one computer system communicates with another computer system. In one 
embodiment, the computer communication system provides a modem monitor and control 
system that provides modem monitoring and control without requiring user interaction or 
switching the modem between data and command modes. 



2 
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DISCLOSURE QFTHg IjWENTIQN 

The principles according to the present invention can be realized through a 
communication system for monitoring, controlling, or configuring communication parameters 
of a remote communication device from a local communication system or a local 
5 communication device from a remote communication system. For example, the 
* communication system monitors a communication channel that is created between two 
modems and controls the second modem by adjusting internal settings of the second modem 
that represent communication parameters. The second modem is communicatively coupled to 
the first modem to carry out ongoing communications between the first modem and the 

10 second modem through the communication channel. Further, a software module is associated 
with the first modem, and the software module accesses the internal settings of the second 
modem via the communication channel and performs diagnostics using the internal settings 
of the second modem. Of course, the software module could access the internal settings of 
the first modem directly and perform diagnostics using the internal settings of the first 

15 modem. Further, the software module can control the internal parameters of the either the 
second modem or the first modem regardless of which modem the software module is 
associated with. 

The software module of the communication system typically includes a modem 
interface that interacts with the software module and assists the software module in 

20 performing diagnostics using the internal parameters of either the first or the second modem. 
Also, the software module accesses the communication channel transparently to the ongoing 
communications between the first modem and the second modem when the software module 
performs the diagnostics. Further, the software module accesses the communication channel 
without detrimentally affecting the ongoing communications between the first modem and the 

25 second modem. In another embodiment, the software module performs diagnostics using the 
internal parameters of the second modem via the same communication channel that is used to 
carry out ongoing communications between the first modem and the second modem. Of note, 
the software module can also control the internal parameters of the second modem. 
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The diagnostics performed by the software module of the communication system 
include monitoring a data stream in the communication channel in view of the internal 
settings of the second modem. Further, the diagnostics performed by the software module 
comprise configuring the internal settings of the second modem based on information 
obtained regarding the data stream between the first modem and the second modem. In 
addition, the diagnostics performed by the software module comprise controlling the internal 
settings of the second modem according to information obtained regarding the data stream 
between the first modem and the second modem. 

It should be noted that the software module may include either a user interactive 
interface for diagnostics, or an automatic interface for diagnostics that requires no further user 
interaction. Further, the communication system may include a plurality of software modules 
being associated, respectively, with each of a plurality of modems. Regardless of the number 
of modems in the communication system, the modems are communicatively coupled via a 
network. The network is typically selected from the group consisting of a local area network, 
a wide area network, and a global area network, however, the network may include any 
combination of a local, wide, or global area network. In other words, the network could 
operate according to almost any existing network protocol, e.g., a peer-to-peer network, a 
transmission control protocol/Internet protocol network (TCP/IP), etc. 

In another embodiment, the present invention can be described as a communication 
system comprising a first communication device having internal parameters; a second 
communication device having internal parameters and being communicatively coupled to the 
first communication device; a communications link that passes a data stream between the first 
communication device and the second communication device; and a module associated with 
the communications link that adjusts the internal parameters of one of the communication 
devices based on characteristics of the internal parameters of either the first communication 
device, the second communication device, or both. 

In this embodiment, the module may include a communication interface that interacts 
with the communications link such that the module operates transparently to the data stream 
of the communications link. Further, the first communication device may be a local 
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communication device and the second communication device may be a remote 
communication device. In addition, similar to the first embodiment, the communications link 
operates on a network such as a local area network, a wide area network, or a global area 
network or a combination thereof. In many embodiments, the communication system is 
5 designed for modems operating in a computer communication system. Thus, to assist in 
understanding the principles according to the present invention, the exemplary embodiments 
are generally described using computer systems communicating with modems. 

A method for adjusting parameters of a communication system includes steps such as 
establishing a communications link between a first communication device and a second 

10 communication device, each communication device having internal parameters influencing 
communication protocols on the communications link. In addition, the steps include 
obtaining a software module for interacting with the communications link; retrieving, with 
the software module, characteristics of the first communication device and/or the second 
communication device based on the internal parameters of the first communication device, 

is the second communication device, or both, and based on data passing through the 
communications link; and adjusting the internal parameters according to the retrieved 
characteristics to optimize communication between the first and the second communication 
devices on the communications link. 

Adjusting the internal parameters may include adjusting the internal parameters of the 
20 second communication device, the first communication device, or both. In addition, 
adjusting the internal parameters may include monitoring or controlling the internal 
parameters of the first, the second, or both communication devices. Further, retrieving 
characteristics of the second communication device may comprise retrieving the 
characteristics transparently to the data passing through the communications link and/or 
2 5 retrieving the characteristics such that the data passing through the communications link is 
not detrimentally affected. 



5 
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BRIEF DESCRIPTION OF THE DRAWINGS 

A better understanding of the present invention can be obtained when the following 
detailed description of the preferred embodiment is considered in conjunction with the 
following drawings. 

Figure 1 is a block diagram of an exemplary computer communication system 
according to the principles of the present invention wherein the system is associated with an 
application for providing a computer system access to a communication channel via a 
modem. 

Figure 2 is a block diagram of an exemplary modem monitor/control interface of the 
computer communication system of Figure 1 . 

Figure 3 is a block diagram illustrating an exemplary modem for operation with the 
computer communication system of Figure 1 . 

Figure 4 is a block diagram of an exemplary computer communication system for 
monitoring and controlling both a local modem and a remote modem over a telephone line. 

Figure 5 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a client modem and a server 
modem in a peer-to-peer network. 

Figure 6 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a client modem and a server 
modem across the Internet. 

Figure 7 is a block diagram of an exemplary computer communication system 
operating according to simple network management protocol (SNMP) parameters such that a 
management application performs remote trouble shooting of a modem. 



e> 
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MODEfSI FOR CARRYING OUT THE INVENTION 

Figure 1 is a block diagram of an exemplary computer communication system 100 
that operates according to the principles of the present invention. For ease of understanding, 
the system 100 is associated with a computer software application 102 for providing a 
5 computer system 104 access to a communication channel 106 via a communication device 
such as a modem 108. The computer software application 102 is commonly a typical 
computer telecommunications application such as a "web browser", viz., Netscape™, Internet 
Explorer™, etc., or a modem utility, viz., Procomm™, etc. In short, the computer software 
application 102 utilizes the modem 108 capabilities to communicate with other modems 

10 through the communication channel 106. While the computer software application 102 uses 
the modem 108 to communicate with other modems, the computer communication system 
100 examines the modem parameters of the modem 108 to determine if the modem 
configuration needs to be modified to attain optimal performance through the communication 
channel 106. As stated, the computer communication system 100 is an exemplary 

15 embodiment that is used to facilitate understanding of the principles according to the present 
invention. It should be understood that the present invention applies equally well to 
communication systems that operate with communication devices other than modems. 
However, for ease of understanding, the present invention will be described relative to 
computer communication systems using modems as the communication devices. 

20 The computer communication system 100 includes a modem monitor/control 

application 110 that performs diagnostics on the modem 108 through a modem 
monitor/control interface 112 (the modem monitor/control application 110 and the modem 
monitor/control interface 112 sometimes collectively referred to herein as a "software 
module"). In one embodiment, the computer communication system 100 may perform these 

25 diagnostics through the same communication channel that the modem 108 uses to 
communicate with other modems. Thus, diagnostics can be performed on the "local" modem 
108, on other "remote modems" (not shown in Figure 1), or on both. 

Advantageously, the diagnostics can also occur transparently to ongoing 
communications in the communication channel. Thus, the modem communication 
30 connection, a.k.a., the "data stream", of the modem 108 can pass through the communication 

7 
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channel 106 without being detrimentally affected during diagnostics. - Further, the diagnostics 
can be performed via user interaction through the modem monitor/control application 1 1 0 or, 
alternatively, the diagnostics can be performed independently of user interaction through the 
application 110. As stated, if any changes in the modem parameters are required to obtain 
5 optimal performance in the modem 108, the changes can be made without interruption in the 
data stream. Of course, the modem 108 could be a software modem or a hardware modem or 
any combination thereof, a pure software modem being defined as a modem implemented 
entirely in software and relying on a computer's processor to modulate and demodulate 
signals. Of note, the modem monitor/control interface 112 can be directly coupled to the 
10 modem 108 or the modem monitor/control interface 112 could instead be directly coupled to 
an operating system communication driver 1 14. These components can be combined in other 
manners as well. Further, the term "diagnostics", as used herein, refers to monitoring, 
controlling, or configuring a modem and also refers to other actions that computer software 
performs in relation to communication devices. 

15 Figure 2 is a block diagram of the exemplary modem monitor/control interface 1 12 of 

the computer communication system 100. The modem monitor/control interface 112 
includes a modem monitor/control application programming interface (API) 200, a modem 
monitor/control data link library (DLL) 202 that operates similarly to standard DLL software 
components, and a modem monitor/control driver 204 that operates similarly to standard 

20 software drivers. The API 200 provides code for monitoring and controlling a software 
modem while the modem is running or passing a data stream (see Appendixes A, B, and C). 
API 200 provides an easy method to write applications that provide various diagnostics that 
. monitor parameters that change in real time (such as MSE, baud rate, echo canceller 
coefficiencies, etc.) as well as enabling the writing of applications that allow internal 

2 5 parameters to be modified while a telephony session is in progress. The API 200 can also 
provide easy means for field support by looking at various parameters and causing the 
modem to dump data into a file to be investigated later. Further, trouble shooting can be 
performed by changing various parameters while a data stream is running through the 
- modem. Of note, in a preferred embodiment, the API 200 operates asynchronously and in 

30 parallel with the ordinary modem operation and does not interfere with the data stream. 
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Thus, API 200 provides a true view of the modem parameters and does not slow the data 
transfer process. 

Appendixes A, B, and C include exemplary embodiments of code portions of the API 
200 and include three functions that could be considered the backbone of the API 200. First, 
5 the Modem'Con Figure function configures parameters within the modem and should be called 
only before the modem is activated. Second, the ModemControl function changes parameters 
within the modem to control the modem's operation and can be called during modem 
operation. Finally, the ModemMonitor function returns the current value of a parameter or 
set of parameters within the modem and can also be called during modem operation. The 

10 first parameter of the above functions is a code indicating which parameter (or parameter set) 
to monitor or change. The codes can be easily extended from time to time to provide 
additional visibility and control options for the modem. The same interfaces apply for 
additional parts of the modem such as speakerphone, tone detection/generation, etc. Thus, 
the computer communication system 100 is extendable and easy to use and can be used to 

is monitor and control a modem without interfering with the ordinary operation of the modem. 
Further, the computer communication system 100 provides an easy method to develop 
applications for modem diagnostics and trouble shooting. 

Figure 3 is a block diagram illustrating the exemplary modem 108 for operation with 
the computer communication system 100 that is associated with a computer system 104 for 

20 accessing a network. The exemplary modem 108 includes a port driver 300, a controller 302, 
a data pump abstraction layer 304, an advanced modem operation scheduler 306, a sample 
buffer management 308, a hardware interface 310, and signal processing tasks 312. Of 
course, the exemplary modem 108 could be realized in various manners depending on the 
number of components implemented in software. The components most suited for either a 

2 5 software or a hardware implementation are the controller 302 and the data pump abstraction 
layer 304. Thus, although other components can be implemented in either hardware or 
software, the controller 302 and the data pump abstraction layer 304 are most commonly 
implemented in either hardware or software. 

9 
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Figure 4 is a block diagram of an exemplary computer communication system 400 for 
monitoring and controlling, in a computer system 401, both a local modem 402 and a remote 
modem 404 of another computer system 405 over a telephone line 406. Similar to the 
computer communication system 100, the computer communication system 400 includes a 
modem monitor/control application 408 and a modem monitor/control interface 410. The 
local modem 402 can be monitored/controlled just as the modem 108 is monitored and 
controlled. In addition, the remote modem 404 can be monitored by the computer 
communication system 400 by using some of the bandwidth of the telephone line 406. Of 
course, if the communication devices were not modems and they communicated across 
something other than a telephone line, similar usage of the bandwidth on the line would 
enable functionality of the communication system 400. 

Referring to the telephone line 406, a data stream is created between the local modem 
402 and the remote modem 404 that represents a modem connection. The telephone line 406 
is used to transfer modem diagnostics and/or control information to/from the remote modem 
404 by either "stealing" some of the data bits or using an alternative channel whenever 
applicable (e.g., V.34 control channel). The extraction of the diagnostics can be performed in 
one of at least two manners: 

1. A specific application can be run on the remote side that extracts modem 
parameters from the data stream and then sends them via the modem to the local 
side. The specific application can also receive control commands from the local 
modem and apply the commands to the remote modem. 

2. The remote modem itself multiplexes the diagnostics in the data stream (or the 
control channel) and monitors control commands without any interference from 
outside. The multiplexing/demultiplexing can be performed on any of the 
following two levels: by a data pump, or by an active data protocol (V.42, V.17). 
This second implementation for extracting diagnostics from the data stream is 
particularly suitable for software modem implementations where the modem can 
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be easily modified for that kind of data manipulation and a wide variety of modem 
parameters can be extracted (e.g., see ModemMonCtrl API of the Appendixes). 

In this manner, modem parameters from the remote modem 404 can be monitored and 
the remote modem 404 can be controlled with new parameters being set in the remote modem 
404 from the computer communication system 400. Of course, the data stream between the 
local modem 402 and the remote modem 404 is ongoing and, potentially, the data stream 
passes without interruption from the computer communication system 400 regardless of 
whether the modems are software, hardware, or combination software/hardware modems. 

Figure 5 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a client modem 500 in a local 
computer system 501 and a server modem 502 in a remote computer system 503. The local 
and remote computer systems 501, 503 communicate across a peer-to-peer network 504. A 
client computer communication system 506 communicates with the client modem 500 while 
telecommunication software or application 508 having an operating system communication 
driver 510 uses the client modem 500 to maintain a modem connection across the peer-to- 
peer network 504. Similar to the computer communication systems 100 and 400, the client 
computer communication system 506 operates in a manner to monitor/control the client 
modem 500 by a client modem monitor/control application 509 or by the server modem 502 
and a server computer communication system 512. The difference in this embodiment 
pertains to the computer communication systems including both the client computer 
communication system 506 and the server computer communication system 512. This 
arrangement is provided to ensure accurate monitoring and/or controlling of both server and 
client modems, whereby, the client modem 500 is monitored and controlled by a server 
modem monitor/control application 514. In addition, this embodiment demonstrates the 
flexibility of the system according to the present invention. 

Figure 6 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a client modem 600 in a local 
computer system 601 and in a remote computer system 603. The local and remote computer 
systems 601, 603 communicate across a network 604. This embodiment illustrates a structure 

11 
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similar to Figure 5 except that, rather than peer-to-peer network 504, the local and remote 
computer systems 601, 603 communicate across a network 604 such as the Internet. Of 
course, the same advantages and benefits previously described in relation to modem 
monitoring, control, and diagnostics are realized when the modem 600 operates across the 
5 Internet through Internet service providers (ISPs). This extends the flexibility of the system 
by allowing the client modem 600 to be monitored and controlled from any remote computer 
system through connection to the server computer communication system 608. Of course, if 
communication devices other than modems are used to implement communication across the 
network 604, monitoring/controlling/configuring (i.e., diagnostics) can be performed in a 
10 similar manner as described herein. 

Figure 7 is a block diagram of an exemplary computer communication system 
operating according to simple network management protocol (SNMP) parameters such that a 
management application 700 in a computer system 701 performs remote trouble shooting of a 
modem 702 in another computer system 703. This exemplary embodiment demonstrates how 

is a single manager or system administrator monitors and controls numerous client modems 
across a network 704. The network 704 will commonly be a network such as the Internet. In 
this embodiment, SNMP serves as the underlying protocol for. the management application 
700 because SNMP is a common network management protocol. Thus, a single manager can 
monitor and control modems such as the modem 702. There is also no limitation as to where 

20 on the network 704 that the manager resides, as long as the manager has access to the server. 
Additional computer systems 706 are illustrated and are used as support tools for the 
management application 700. The additional computer systems 706 each support a modem 
web page 708 that enables remote diagnostics of the modem 702 from anywhere on the 
network 704. Of course, other network management protocols could be used to implement 

2 5 the principles according to the" present invention and the description of SNMP operating over 
the network 704 should not be construed to limit the appended claims. 

The above-listed sections and included information are not exhaustive and are only 
exemplary for certain computer/modem/network systems. The particular sections and 
included information in a particular embodiment may depend upon the particular 

12 
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implementation and the included devices and resources. Although a system and method 
according to the present invention has been described in connection with the preferred 
embodiments, it is not intended to be limited to the specific form set forth herein, but, on the 
contrary. > l * s intended to cover such alternatives, modifications, and equivalents as can be 
5 reasonably included within the spirit and scope of the invention as defined by the appended 
claims. 
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Appendix A 



#ifndef _MODEM_CTRL_H_ 
#define _MODEM_CTRL_H_ 

5 #incl.ude <Windows.h> // To provide types definition, can be replaced by 
any alternative type defining file 
# include "ModemCodes . h" 

ffifdef cplusplus 

10 extern "C" { 
#endif 

VOID WINAPI ModemGetLastError ( PCHAR pBuf , DWORD nBuf ); 

15 /* 

The GetModemCodesVersion function returns the version of the control codes 
header file. 

It should be used to verify cohemece between the modem control API user 
and provider . 
20 */ 

DWORD WINAPI ModemGetCodesVersion ( ) ; 



25 /* 

The ModemOpen function returns a handle that can be used to access 
a data-pump object. 

Parameters : 

30 dwDpIdCode - Specifies the type identification code of the data pump. 

This value identifies the specific data pump to be monitored or 
controled. 

The data pump type identification codes are defined by the type 
RK_DP_IDS 
35 (file "ModemCodes .h" ) . 

Return Values : 

If the specified data pump type exists and the function succeeds, 
the return value is an open handle to the specified modem. 
4 0 If the function fails, the return value is INVALID_HANDLE_VALUE . 
*/ 

HANDLE WINAPI ModemOpen ( 
DWORD dwDpIdCode 

45 ) ; 

/* 

The ModemClose function closes an open object handle. 
50 , 
Parameters : 

hModem - Identifies an open object handle to one of the following objects: 

14 
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CModem 



Return Values : 

5 If the function succeeds, the return value is TRUE. 
If the function fails, the return. value is FALSE. 
*/ 

BOOL WINAPI ModemClose ( 
10 HANDLE hModem // handle to object to close 

) ; 



/* 

15 The functions: ModemConf igure , ModemControl , ModemMonitor 
send a control code to a specified CModem object, 

causing the corresponding device to perform the specified operation. 
ModemConf igure has to be called BEFORE the specified modem has been 
activated. 

2 0 ModemControl and ModemMonitor may be called DURING modem operation. 
Parameters : 

hModem - Handle to the CModem instance that is to perform the operation. 

Call the CreateModem function to obtain a CModem handle. 

2 5 dwConf igCode/dwControlCode/dwMonitorCode - Specify the control code for the 

operation . 

This value identifies the specific configuration to be 

performed by 

ModemConf igure/ModemControl /ModemMonitor respectively. 

3 0 The control codes are defined by types 

RK_CFG_CODES/RK_CTL_CODES/RK_MON_CODES 

(file "ModemCodes . h" ) . 
plnBuffer - Pointer to a buffer that contains the data required to perform 
the operation. 

3 5 This parameter can be NULL if the dwConfigCode parameter 

specifies an operation 

that does not require input data. 
nlnBuf f erSize - Specifies the size, in bytes, of the buffer pointed to by 
plnBuffer. 

40 pOutBuffer - Pointer to a buffer that receives the operation's output data. 

This parameter can be NULL if the dwConfigCode parameter 
specifies an operation 

that does not produce output data. 
nOutBuf f erSize - Specifies the size, in bytes, of the buffer pointed to by 

4 5 pOutBuffer. 

pBytesReturned - Pointer to a variable that receives the size, in bytes, 
of . the data stored into the buffer pointed to by pOutBuffer. 

Return Values : 

50 If the function succeeds, the return value is TRUE. 

If the function fails or the specified operation is not supported 

for the specified object, the return value is FALSE. 

*/ 

55 BOOL WINAPI ModemConf igure ( 
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HANDLE 


hModem, 






interest 








DWORD 


dwConf igCode , 


// 




PVOID 


plnBuf f er , 


// 


5 


DWORD 


nlnBuf f erSize , 


// 




PVOID 


pOutBuf f er , 


// 




DWORD 


nOutBuff erSize , 


// 




PDWORD 


pBytesReturned 


// 




coun: 






10 


) ; 








BOOL W1NAPI ModemControl ( 






HANDLE 


hModem, 






inheres: 






15 


DWORD 


dwControlCode , 


// 




PVOID 


plnBuf f er , 


// 




DWORD 


nlnBuf f erSize , 


// 




PVOID 


pOutBuf f er , 


// 




DWORD 


nOutBuff erSize, 


// 


20 


PDWORD 


pBytesReturned 


// 




count 
) ; 








BOOL WINAP1 ModemMonitor ( 




25 


HANDLE 


hModem , 






interest 








DWORD 


dwMonitorCode , 


// 




PVOID 


plnBuf fer , 


// 




DWORD 


nlnBuf f erSize , 


// 


30 


PVOID 


pOutBuf f er , 


// 




DWORD 


nOutBuff erSize , 


// 




PDWORD 


pBytesReturned 


// 




count 







) ; 

35 



#ifdef cplusplus 

} 

#endif 

40 

#endif //_MODEM_CTRL_H 



/ / handle to CModem instance of 

control code of operation to perform 
pointer to buffer to supply input data 
size of input buffer 

pointer to buffer to receive output data 
size of output buffer 

pointer to variable to receive output byte 



// handle to CModem instance of 

control code of operation to perform 
pointer to buffer to supply input data 
size of input buffer 

pointer to buffer to receive output data 
size of output buffer 

pointer to variable to receive output byte 



/ / handle to CModem instance of 

control code of operation to perform 
pointer to buffer to supply input data 
size of input buffer 

pointer to buffer to receive output data 
size of output buffer 

pointer to variable to receive output byte 
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Appendix B 

#ifndef ._MODEM_CODES_H_ 
#define _MODEM_CODES_H_ 

5 # define MODEM_CODES_VERSION 8 

// rate masks returned by RKMON_SUPPORTED_BIT_RATE 





#def ine 


RK_ 


_RATE_ 


_MASK_ 


_75 


0x00000001 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


_3 0 0 


0x00000002 


10 


#define 


rk] 


]rate] 


_MASK_ 


~60 0 


0x00000004 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


_1200 


0x00000008 




#define 


rk" 


_RATE_ 


"mask] 


]2400 


0x00000010 




#define 


RK_ 


_RATE_ 


_MASK_ 


_4 8 00 


0x00000020 




#def ine 


RK_ 


_rate_ 


_MASK_ 


7200 


0x00000040 


15 


#define 


RK~ 


]rate] 


_MASK_ 


]9600 


0x00000080 




#def ine 


RK_ 


_rate_ 


_MASK_ 


_12O00 


0x00000100 




#define 


RK . 


rate_ 


_mask] 


_14400 


0x00000200 




#define 


rk] 


_rate_ 


_MASK_ 


_16800 


0x00000400 




#def ine 


rk] 


_rate_ 


_MASK_ 


19200 


0x00000800 


20 


#define 


RK. 


_RATE_ 


_MASK_ 


21600 


0x00001000 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


24000 


0x00002000 




#define 


RK_ 


_RATE_ 


_MASK_ 


26400 


0x00004000 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


2 8 8 0 0 


0x00008000 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


_31200 


0x00010000 


25 


#define 


RK_ 


_RATE_ 


_MASK_ 


_33600 


0x00020000 




#define 


RK_ 


_RATE_ 


]mask] 


]32000 


0x00040000 




#define 


RK_ 


_RATE_ 


_MASK_ 


_34000 


0x00080000 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


_36000 


0x00100000 




#define 


rk] 


_RATE_ 


_MASK_ 


]38000 


0x00200000 


30 


#define 


RK_ 


_RATE_ 


_MASK_ 


4 0 000 


0x00400000 




. #def ine 


rk] 


"rate] 


_MASK_ 


42000 


0x00800000 




#define 


rk_ 


_RATE_ 


_MASK~ 


44000 


0x01000000 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


_46000 


0x02000000 




#def ine 


rk] 


RATE_ 


]mASK~ 


]4 8 0 00 


0x04000000 


35 


#def ine 


rk_ 


_RATE_ 


_MASK_ 


5 0 000 


0x08000000 




#define 


rk] 


RATE_ 


]mask_ 


*52000 


0x10000000 




#def ine 


rk_ 


_RATE_ 


_MASK_ 


54000 


0X20000000 




#def ine 


RK_ 


_RATE_ 


_MASK_ 


.56000 


0X40000000 



4 0 // DataPump type codes 
typedef enum { 

RKID_V32BIS = 0, 

RKIDJV34 , 

RKID_V22BIS, 
4 5 RKID_V23 , 

RKID_V21, 



RKID_V17 , 
RKID_V2 9, 
5 0 RKID_V27 , 

RKID_V8, 



SOOCtD: <WO 9S4S695A1.L> 



WO 99/45695 



PCT7US99/04841 



RKID_TONE_DET, 
RKID_TONE_GEN , 
RKID_DTMF_DET , 
5 RKID_DTMF_GEN , 

RKID_CR_TONE_DET , 
RKID_CR_TONE_GEN 

RKID_RKS AMPLE , 
1 0 RKI D_ANS_DET , 

RKID_ANS_GEN, 
RKID_WINAC / 
RKID_ROKV4 2 , 

15 RKID_K56FLEX, 
RKID_BEIiL10 3 , 
RKID_BELL212A, 
RKID_SPKP, 
RKID__VOICE, 

20 

RKID_V90, 

RKID_AMOS , 

25 RKID_LAST, 
} RK_DP_IDS; 



Offset definitions: 



// V8, V8BIS 



// V22, Bell-212A 

// V23, Bell-103 

// V27, V27BIS, V27TER, V29, V17 

// V32, V32BIS 



// K56FI4EX, V90 



30 #define COMMON_RK_CODES 0 

#define RKSAMPLE_RK_CODES 2 00 0 

# define WINAC_RK_CODES 3 000 

#define V4 2_RK_CODES 4 000 

35 

#define AUTOMODE_RK_CODES 6 00 0 

# define V8_RK_CODES 700 0 

#define V2i_RK_CODES 1000 o 

4 0 #define V22_RK_CODES 11000 

#define FSK_RK_CODES 12 000 

# define FAX_RK_CODES 14 000 

4 5 #define V3 2_RK_CODES- 1600 0 

#define V34_RK_CODES 18 00 0 

#define V90_RK_CODES 20 000 

50 

#define SPKP_RK_CODES 25 000 

# define VOICE_RK_CODES 26 000 

55 #define AMOS RK CODES 27000 
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// Modem Config Codes Parameter 
(In) Parameter (Out) 

typedef enum 
5 { 

// ********* Common Constants ********** 

'// Select Symbol Rate (no impact if Autorate is enabled) 
RKCFG_TX_SYMBOL_RATE = COMMON_RK_CODES , // INT - 

10 Symbol Rate None 

RKCFG_RX_S YMBOL_RATE , / / INT 

- Symbol Rate None 

// Force Bit Rate 

RKCFG_BIT_RATE_RX_MAX , / / INT 

15 - Bit Rate None 

RKCFG_B I T_RATE_TX_MAX , / / INT 

- Bit Rate None 

RKCFG_BIT_RATE_RX_MIN, // INT 

- Bit Rate None 

20 RKCFG_BIT_RATE_TX_MIN, // INT 

- Bit Rate None 

// Select connection type ( Half or Full Duplex ) 

RKCFG_CONNECTION_TYPE , // DWORD 

25 (FDplex=0,HDplex=l) None 

// Tx Transmittion Power: {Minimum, Maximum, Default, Offset} 
// (values in dBm, offset in dB) . Offset is for compensation on 
hardware gain. 

3 0 RKCFG_TX_S IGNAL_POWER , / / 

char [4] None 

// Enable/Disable Rate Renegotiation 

RKCFG_RENEG_ENABLE, // 
35 BOOL - Yes /No None 

// Enable/Disable Retrain 

RKCFG_RETRAIN_ENABLE , - _ // 
BOOL - Yes/No ^ None 

40 // Enable/Disable Rx Freeze 

RKCFG_RX_FREEZE_ENABLE , / / 

BOOL - Yes/No None 
// Enable/Disable Echo Canceller Freeze 
RKCFG_EC_FREE2E_ENABLE , / / 

4 5 BOOL - Yes /No None 

RKCFG_RECORD_SESS ION , / / 

BOOL - Yes /No None 

RKC FG_S E S S I ON_NAME , // 

5 0 char * name None 

RKCFG_NO_CARRIER_TIMEOUT, // 
DWORD - in seconds None 
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15 



20 



RKC FG_S TART_AT_DATA , 
BOOL - Yes /No 



None 



RKCFG_REMOTE_IS_ROCKWELL , 
BOOL - Yes /No None 

RKCFG_MODEM_SETTINGS , 
// ********* W in AC Constants ************* 

RKCFG_EC_MODE = WINAC_RK_CODES , 
DWORD ( ERR0R_CONTR0L_M0DE ) 
RKCFG_CMPRS_MODE , 
DWORD ( COMPRESS I ON_MODE ) 
RKCFG_ACTIVE_MODULATI0N , 
DWORD (RK_DP_IDS) 



// 



****** Auto -Mode Constants ******** 



// Enable /Di sable Automode 

RKCFG_AUTOMODE_ENABLE = AUTOMODE__RK_CODES , / / 
Yes/No None 

// Transmit Timeout' for detection for V32 
RKCFG_TRANSMIT_TIMEOUT , 
DWORD ms None 



// 
// 



// 
// 
// 



// 



30 



35 



// ********* v8 Constants ********** 

RKCFG_V8_SUPPORT_CI = V8_RK_CODES , // 
Yes /No None 

RKCFG_V8_CI_CALLING_FUNCTION_SEQUENCE , / / 

None 

RKCFG_V8_C I_ON_CADENCE , 
DWORD ms cadence None 
RKCFG_V8_CI_OFF_CADENCE , 
DWORD ms cadence None 
RKCFG_V8_AS_CI_DET , 
BOOL None 
// ********* V21 Constants ********** 



RKCFG_V21RX_HIGH_CHANNEL = V2 l_RK_CODES , / / 
4 5 Yes /No None 

RKCFG_V2 1TX_HIGH_CHANNEL , 
BOOL - Yes/No None 

RKCFG_V2 1 _D AT A_MODE , 
50 BOOL None 

II ********* V22 constants (V22, Bell-212A) ******* 



// 
// 



// 



// 



RKCFG_V2 2_TO_BELL_212A = V22_RK_CODES, 
5 5 Yes/No None 

20 



// 



BOOL 



BYTE 



BOOL - 
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// 



********* 



FSK Modulations Constants (V23, Bell-103) ****** 



RKCFG_FSK_BACK_CHANNEL = FSK_RK_CODES , 
Yes /No None 



// 



BOOL - 



RKCFG_FSK_V2 3_CHANNEL , 
BOOL - Yes/No 



// 



None 



RKCFG_FSK_BELL103_CHANNEL, 
BOOL - Yes /No None 



// 



// 



RKCFG_FSK_FOR_CID , 
BOOL - Yes /No None 
******* p ax Constants (V27, V2 9, V17) ********** 



// 



20 



// Define Retrain between Pages as Short or Long 



RKCFG_LONG_ RETRAIN 
( TRUE = Long ) None 



= FAX RK CODES, 



// 



it******** V32 Constants ********** 



// 



BOOL 



25 



RKCFG_V3 2 E i S_T0_V3 2 
Yes/No None 
RKCFG_V3 2 _TR ELL I S_SUPPORT 
BOOL - Yes /No 



V32 RK CODES, 



None 



// 



// 



BOOL 



// 



********* 



V34 Constants 



********** 



30 



// Select Carrier Frequency 
RKCFG_RX_CARRTER_FREQ = V34_RK_CODES , 
V34 carrier t None 



// 



// Enable/Disable Transmit Power Drop 

3 5 RKCFG_TX_POWER_DROP_ENABLE, 

BOOL - Yes /No None 
// Select Transmit Power Level 
RKCFG_TX_P0WER_DROP , 
- Level None 

4 0 // Select Requested Power Drop 

RKCFG_REQUESTED_POWER_DROP , 
DWORD None 



// 
// 
// 



INT 



// Enable/Disable Precoding 
4 5 RKCFG_PRECODING_ENABLE , 

BOOL - Yes /No None 
// Set Precoding Coefficients 
RKCFG_PRECODING_COEFFS , 
Array of coeffs None 



// 
// 



SHORT [6] - 



// Transmitter Preemphasis Filter 
RKCFG_TX_PRE£MPHASIS_FILTER , 
Filter Index None 

// Requested Preemphasis Filter 



// 
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RKCFG_REQUESTED_PREEMPHASIS_FILTER, // INT - 

Filter Index None 

// Enable/Disable Constellation Expansion 
5 RKCFG_C0NSTELATION_EXPAND_ENABLE , // BOOL - 

Yes /No None 

// Enable/Disable Warping 

RKCFG_WARP_ENABLE , // 
BOOL - Yes /No None 
10 // ********* V90 Constants (K56FLEX, V90) ********** 

// set the encoding law for flex 1 indicates A-law coding, 0 indicates 

u- law 

RKCFG_ENCODING_LAW = V90_RK_CODES , // BOOL 

15 (TRUE=A_Law) None 

// ********* SpeakerPhone Constants ********** 

// Hardware Delay 

2 0 RKCFG_EC_DELAY = SPKP_RK_CODES , / / { SPKP_MODULE , INT - No of 

Samples} None 

// Cross -Correlator Length 

RKCFG_CC_LENGTH , / / INT 

- No of Taps None 

25 

RKCFG_DMP_MAS K , 

RKCFG_INITIAL_FULL_DUPLEX_MEASURE , 

3 0 } RK_CFG_CODES ; 

// Modem Control Codes 
typedef enum 

{ 

35 // ********* common Constants ********** 
// Initiate Retrain 

RKCTL_RETRAIN = C0MMON_RK_CODES , // None 

None 

40 // Initiate Rate Renegotiation 

RKCTL_RENEG , // 

INT - Bit Rate None 

// Terminate Connection Gracefully 

RKCTL_CLEARDOWN , / / 

4 5 None None 

// Squelch Tx Signal 

RKCTL_TX_SQUELCH , / / 

None None 



50 



// Use the SendCommand 

RKCTL_SEND_COMMAND , // 



{DWORD [2]- Command, Param} 
55 // WinAC constants 
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RKCTL_MODEM_SLEEP 
None 



WINAC_RK_CODES , 



// 



DWORD 



// 



** Fax Constants (V2 7, V2 9, VI 7) ********** 



10 



// Define Retrain between Pages as Short or Long 
RKCTL_LONG_RETRAIN = FAX_RK_CODES , // 
( TRUE = Long ) None 

// ********* V34 Constants ********** 

// Must be sent before RKMON_DATA_RES_ECHO_GET 
RKCTL_DATA_RES_ECHO_REQUEST=V34_RK_CODES , // 
None 

// ********* speakerPhone Constants ********** 



BOOL 



None 



// 



45 



// Speakerphone Mode (FD, HD, HS) 
RKCTL_SPKP_MODE = SPKP_RK_CODES , 

None 
// Output Mute 
RKCTL_IOJVIUTE, 

{ SPKP_PROBE , BOOL - Yes/No} None 

// Echo Cancellers . 

RKCTL_FILTER_LENGTH , 
of Taps } None 

RKCTL_E C_0 P ERATE , 
Yes/No} None 

RKCTL_ADAPT_ENABLED , 
Yes /No} None 

// AGC and' Sw-Loss 

RKCTL_AMP_ENABLED , 

{ SPKP_MODULE , BOOL - Yes/No} None 

// Gains 

RKCTL_GAIN , / / { SPKP_MODULE* , INT* / FLOAT* 

Gain, GAIN_FORMAT*} None 

RKCTL_INIT_GAIN, 
RKCTL_MAX_GAIN , 
RKCTL_FULL_DUPLEX_MEASURE , 

RKCTL_NOISE_INSERTION_LENGTH, 
RKCTL_NOISE_INSERTION_ENABLE , 

R KCTL__ FAD E_ I N_LENGTH , 
RKCTL FADE IN ENABLE, 



SPKPMode 



// 

// { SPKP_MODULE , INT - No 
// { SPKP_MODULE , BOOL - 

// {SPKP_MODULE,BOOL - 

// 



55 



RKCTL_UPSTEP, 

RKCTL_MIN_LINE_OUT_POWER , 

R KCT L__ L I NE_OUT_S I L EN C E__G A I N_REDUCT I ON , 

// ********* AMOS Constants ********** 

RKCTL_CREATE_DATAPUMP = AMOS RK CODES , 
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RKCTL_DESTROY_DATAPUMP , 

} RK_CTL_CODES ; 

// Modem Monitor Codes 
typedef enum 

{ 

// common Constants 



RKMON_TX_SAMPLE_RATE = COMMON_RK_CODES , 
DWORD - Sample Rate 



// 





RKMON_RX_SAMPLE_RATE , 




// 




None 


DWORD 


- Sample Rate 




RKMON_TX_S YMBOL_RATE , 




// 


15 


None 


INT - 


Symbol Rate 




RKMON_R X _S Y M B 0 L_RATE , 




// 




None 


- INT - 


Symbol Rate 




RKMON_TX_E T T_RATE , 








None 


INT - 


Bit Rate 


20 


RKMON_RX_B J T_RATE , 








None 


INT - 


Bit Rate 



// 
// 



30 



35 



40 



50 



RKMON_TX_CARR I ER_FREQUENCY , 

DWORD - (Hz) 
RKMON_RX_CARR I ER_ FREQUENCY , 

DWORD - (Hz) 
RKMON_TX_SIGNAL_POWER , 

None Float - (dBm) 

RKMON_RX_SIGNAL_POWER , 

None Float - (dBm) 



// 
// 



// 
// 



None 
None 



// Constellation points 

RKMON_RX_SCATTER, // 

None . float* - pointer to pairs of points 

// Gain needed for scatter plot 

RKMON_RX_NORM_FACTOR , / / 

None float 



RKMON_ROUND_TRI P_DELAY , 
None INT 



// M.S.E at Rate selection [dB] 
RKMON_BASE_MSE , 
None Float 
// Mean Square Error [dB] 
RKMON_MSE, 

None Float 

// Signal to Noise Ratio (dB) 
RKMON_SNR , 

None Float 
RKMON_EQM , 

None float - 



// 

R.T.D in 8k samples per sec. 

// 



// 

// 
// 



(dB) 
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RKMON_SUPPORTED_BIT_RATES_MASK , // None 

DWORD (masks of RK_RATE_MASK_ defined above) 
RKMON_FE_ECHO_DEI»AY , 

5 R KMON_AUD IO_TX_SAMPLE_RATE , / / 

None DWORD - Sample Rate 

R MMON_AUDIO_RX_SAMPLE_RATE , / / 

None DWORD - Sample Rate 

10 RKKOK_SETTINGS_INFO, 

RKM0N_SETTINGS_BLOCKS , 
// ** Rksample Constants"********** 

// Num of microseconds in last interrupt 
15 RK>'.OK_L.AST_INT_CPU = RKS AM PLE_RK_ CODES , // None 

DWORD 

/ / Num of microseconds between last 2 interrupts 
RKMOK_LAST_INT_LATENCY , // 
None DWORD 
20 // Num of microseconds in longest interrupt 

RKMON_KAX_INT_CPU , // 
None DWORD 

// Longest latency between 2 interrupts (microseconds) 

RKMON_MAX_INT_LATENCY , // 
25 None DWORD 

// Num of samples overrun occcurred in the past 

RKMON_SAMPLES_OVERRUNS , / / 

None DWORD 

// Num of samples occcurred in the past 
30 RKMON_SAMPLES_UNDERRUNS, // 

None * DWORD 

// Num of bus overruns occcurred in the past 
RKMON_BUS_OVERRUNS , / / 

None DWORD 
35 // Num of bus underruns occcurred in the past 

RKMON_BUS_UNDERRUNS , // 
None DWORD 
// Operating speed 

RKMON_OPERATING_SPEED, // 
4 0 None DWORD 



// ********* winAc Constants 



// Index (WinAc style) of the active modulation 

4 5 RKM0N_ACTIVE_MODULATION=WINAC_RK_CODES, // None 

DWORD 

RKMON_MODEM_ STATE , // 
None DWORD 

RKM0N_MODEM_SLEEP, // 

5 0 None DWORD 

// RKMON_CALL_SETUP_RES - identical 
// to field no. 1 in AT#UD 

R KMON_CALL_SETUP_RES , / / 

None DWORD 
55 // RKMON_MULTI_MEDIA_MODE - identical 

25 
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//to field no. 2 in AT#UD 

RKMON_MULTI_MED I A_MODE , / / 

None DWORD 

// RKM0N_V8_CM - identical to field no. 

// 4 in AT#UD. Returns a pointer to string. 

RKMON_V8_CM, // 

None PCHAR 

// RKMON_VB_JM - identical to field no. 

// 5 in AT#UD . Returns a pointer to string. 

RKMON_V8_JM, // 

None PCHAR 

// RKMON_TX_NEG_RES - identical to 

// field no. 2 0 in AT#UD 

RKMON_TX_NEG_RES , // 

None DWORD 

// RKMON_RX_NEG_RES - identical to 

// field no. 21 in AT#UD 

RKMON_RX_NEG_RES , // 

None DWORD 

// RKMON_CARRIER_LOSS_EV_CNT - 

// identical to field no. 30 in AT#UD 

RKMON_CARRIER_LOSS_EV_CNT , I / 

None DWORD 

// RKMON_RATE_RENEG_EV_CNT - 

// identical to field no. 31 in AT#UD 

RKMON_RATE_RENEG_EV_CNT , / / 

None DWORD 

// RKMON_RTRN_REQ - identical to field 

// no. 3 2 in AT#UD 

RKMON_RTRN_REQ , / / 

None DWORD 

// RKMON_RTRN_GRANTED - identical to 

// field no. 33 in AT#UD 

RKMON_RTRN_GRANTED , / / 

None DWORD 

// RKMON_PROTOCOL_NEG_RES - identical 

// to field no. 40 in AT#UD 

RKMON_PROTOCOL_NEG_RES , // 

None DWORD 

// RKMON_EC_FRAME_SIZE - identical to 

// field no. 41 in AT#UD 

RKMON_EC_FRAME_S IZE , / / 

None DWORD 

// RKM0N_EC_LINK_TIMEOUTS - identical 

// to field no. 42 in AT#UD 

RKMON_EC_LINK_TIMEOUTS , // 

None DWORD 

// RKMON_EC_LINK_NAKS - identical to 

// field no. 43 in AT#UD 

RKMON_EC_LINK_NAKS , / / 

None DWORD 

// RKMON_CMPRS_NEG_RES - identical to 

// field no. 44 in AT#UD 

RKMON_CMPRS_NEG__RES , / / 

None DWORD 
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// RKMON_CMPRS_DICT_SIZE - identical to 
// field no. 45 in AT#UD 

RKMON_CMPRS_DICT_SIZE, // 
None DWORD 
5 // RKMON_TX_FLOW_CTRL - identical to 

// field no. 50 in AT#UD 

RKMON_TX_FLOW_CTRL , / / 

None DWORD 

// RKMON_RX_FLOW_CTRL - identical to 
10 *~ // field no. 51 in AT#UD 

RKMON_RX_FLOW_CTRL, // 

None DWORD 

// RKMON_TOTAL_TX_CHARS - identical to 

// field no. 52 in AT#UD 
15 RKMON_TOTAL_TX_CHARS , // 

None DWORD 

// RKMON_TOTAL_RX_CHARS - identical to 

// field no. 53 in AT#UD 

RKM0N_TOTAL_RX_CHARS , ^ // 

2 0 None DWORD 

// R KMON_TERM I NAT I ON_CAUS E - identical 
// to field no. 60 in AT#UD 

RKMON_TERMINATION_CAUSE , / / 

None DWORD 
25 // RKMON_CALL_WAIT_EV_CNT - identical 

// to field no. 61 in AT#UD (not supported) 
RKMON_CALL_WAIT_EV_CNT, // 
None DWORD 

RKMON_CPU_VENDOR , / / 

3 0 None PCHAR 

RKMON_CACHE_S I2E , / / 

None DWORD 

R KMON_NUMB E R_C AL LED , / / 

None PCHAR 

3 5 RKMON_TIMER_RESOLUTION / // H 

DWORD 

// ********* V42 Constants ********** 

4 0 // Number of V4 2 BLERS 

RKMON_BLER = V42_RK_CODES , // None 

DWORD 

// ********* Fax Constants (V27, V29, V17) ********** 

45 

// Whether Retrain between Pages is Short or Long 

RKMON_LONG_RETRAIN = FAX_RK_CODES , // None 

BOOL (TRUE=Long) 

50 // ********* V34 Constants ********** 

// Transmit Power Drop [dB] 

RKM0N_TX_POWER_DROP = V34_RK_CODES , // None 

INT 

55 // Power Drop [dB] that was requested from remote modem 
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10 



RKMON_RX_POWER_DROP , 
None 



INT 



// Transmitter Preemphasis Filter 
RKMON_TX_PREEMPHASIS_FILTER, 

INT - Filter Index 
// other side's Preemphasis Filter 
R KMON_RX_PREEMPHAS I S_F I LTER , 

INT - Filter Index 



// 



// 
// 



None 



None 



15 



20 



// Residual Echo in training [dB] 

R KMON_TRN_RE S I DUAL_ECHO , / / 

None Float 

// Residual Echo in data [dB] (must be sent after 
RKCTL_DATA_RES_ECHO_REQUEST) 

RKMO!J_DATA_RES_ECHO_GET , 
None Float 
// Near End Echo [dB] . 



RKMON_NE_ECH0_POWER , 

None Float 

// Far End Echo [dB] 

RKMON_FE_ECH0_ POWER , 

None Float 

// Timing Drift [ppm] 

RKMON_TIMING_DRIFT , 

None Float 

// Frequency Offset [Hz] 

RKMON_FREQ_OFFSET , 

None Float 



// 
// 
// 



// 
// 



35 



45 



50 



// 



// 



V90 Constants ( K5 6 FLEX , V90) ********** 



// Robbed Bits Signaling 

RKMON_RBS_DETECTED " = V90_RK_CODES , // None 

DWORD RBS frame 0 to 63 (1' indicate robbed bit) 

// PCM Pad 

RKMON_PAD_DETECTED, // 
None DWORD PAD 0= NORMAL , 3=3dBPad 6=6dBPad 



// High Pass filter enabled 

RKMON_H I GH P AS S_ F I LTE R_ EN AB LED , 

None BOOL - Yes/No 



// 



SpeakerPhone Constants ********** 



// Speakerphone Mode ( FD , HD, HS) 
RKMON_SPKP_MODE = SPKP_RK_CODES , 

SPKPMode 

// State 

R KMON_STATE , 

None SPKPState 
// Input-Output Mute 



// 



// 



- None 
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RKMON_IO_MUTE, 

SPKP_PROBE 

RKMON_SATURATION , 

SPKP_PROBE 
5 , RKMON_DC_LEVEL , 

SPKP_PROBE 

// Echo Cancellers 

RKMON_FILTER_LENGTH , 

SPKP_MODULE 
1 0 RKMON_EC_0 PERATE , 

SPKP_MODULE 

RKMON_AD APT_ENAB LED , 

SPKP_MODULE 

RKMON_EC_DELAY , 
15 SPKP_MODULE 

/ / . AGC and Sw-Loss 

RKMON_AMP_ENABLED , 

SPKP_MODULE 

// Powers 
20 RKMON_POWER , 

SPKP_PROBE 

RKMON_NOISE_POWER , 

SPKP_PROBE 

// Gains 
25 RKMON_GAIN, 

{ SPKP_MODULE , GAIN_FORMAT } 

// Gain Estimations 

RKMON_ECHO_PATH_GAIN , 

ECHO_PATH 
30 RKMON_EC_GAIN, 

SPKP_MODULE 

RKMON_RES_ECHO_GAIN , 

SPKP MODULE 



BOOL - 
BOOL - 
FLOAT 



Yes/No 
Yes/No 



INT - No of Taps 
BOOL - Yes /No 
BOOL - Yes /No 
INT - No of Samples 

BOOL - Yes /No 



FLOAT 
FLOAT 



Power [dB] 
Power [dB] 



// 

// 
// 
// 



// 



// 



// 

// 

// 
// 

// 



INT/FLOAT - Gain [Scaled, dB , Linear] 

// 



FLOAT - Gain [dB] 
FLOAT - Gain [dB] 
FLOAT - Gain [dB] 



// 



// 



35 



RKMON_ INI T_G A I N , 

RKMON_MAX_GAIN , 

RKMON FULL DUPLEX MEASURE, 



40 



RKMON_TONE_ DETECT , 

RKMON_NOISE_INSERTION_LENGTH , 
RKMON_NOISE_INSERTION_ENABLE , 

RKMON_FADE_IN_LENGTH , 
RKMON FADE IN ENABLE, 



50 



RKMON_UPSTEP, 
RKMON_MIN_LINE_OUT_POWER , 
RKMON_DM P_MAS K , 

R KMON_L I N E_OUT_S I L EN CE GAIN REDUCTION , 



RKMON_INITIAL_FULL_DUPLEX_MEASURE , 

29 
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// ********* voice Constants ********** 

RKMON_VOICE_AVG_POWER = VOICE_RK_CODES , 

5 } RK_MON_CODES ; 

// SPKP Modules 
typedef enum { 

LINEIN_AMR, 

10 LEC , TONE_DET, RX_SD, RX_SW_L0SS, RX_AGC , 

SPKR_AMP, 
MIC_AMP, 

AEC, TX_SD, TX_SW_LOSS, TX_AGC, 
L I NEOUT_AM P , 
15 ALL_MODULES 

} SPKP_MODULE; 

// SPKP Probing points 
typedef enum { 

2 0 LINEIN, 
LEC_IN, LEC_OUT, 
SPKR, 
MIC , 

AEC_IN, AEC_0UT, 
25 L INEOUT , 

ALL_PROBES 
} SPKP_PROBE; 

// Gain Format: dB or Scaled 0-255 

3 0 . typedef enum { SCALED , DB , LINEAR } GAIN_FORMAT ; 

// Echo Path 

typedef enum { ACOUSTIC , LINE } ECH0_PATH; 

35 // Error Control Mode 

typedef enum { EC_F0RCED, EC_OFF, EC_ON} ERROR_CONTROL_MODE ; 

// Modem global state 

typedef enum { STATE_INITIALIZING, STATE_IDLE , S TATE_OR I G INATE , 

4 0 STATE_ANSWER , 

STATE_V8BIS_HS , /* STATE_MST, */ STATE_TRAINING , 

STATE_CONNECTED , 

STATE_E SCAPED , STATE_LAL , STATE_LAL_E SCAPED , 

STATE_RDL } MODEM_STATE ; 

45 

// Compression Mode 

typedef enum { CMPRS_OFF, CMPRS_0N} C0MPRESSI0N_MODE; 
#endif // _M0DEM CODES_H 



RX_AGC_OUT, 
TX_AGC_OUT, 
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Appendix C 



5 



50 



#include "dlldefs.h" 
#include "ModemCtrl.h" 
#include "appinterf ace ,h" 

#define MAX ERRORMSG LEN 200 



HANDLE hModCtrlVxd = NULL ; 

10 char ErrorMsg [MAX_ERRORMSG_LEN] ; 

HANDLE WINAPI ModemOpen ( DWORD Code ) 
{ 

PCLIENT_INFO pClient; 

15 

if { hModCtrlVxd == NULL | | hModCtrlVxd = = INVALID_HANDLE_VALUE ) { 
#ifndef WINDOWS_NT 

hModCtrlVxd = CreateFile ( "WW . \ \MODCTRL . VXD " , 0, 0/ NULL, 

0, FILE_FLAG_DELETE_ON_CL0SE, 

2 0 NULL) ; 

#else 

hModCtrlVxd = CreateFile (" WW • WMODCTRL0 " , 

GENERI C_READ | GENERIC_WRITE , 
F I LE_SHARE_READ , ' 
25 NULL, 

OPEN_EXISTING, 
0 , 

NULL) ; 

flendif 

3 0 if ( hModCtrlVxd » INVAL I D_HANDLE_VALUE ) { 

strncpyt ErrorMsg, "Failed to load MOD CTRL .VXD' 1 , 
MAX_ERRORMSG_LEN ) ; 

return FALS E ; 

} 

35 } 

unsigned long nBytes; 



BOOL rc = DeviceloControl ( hModCtrlVxd, 

DP_OPEN_MODEM , 

40 &Code, sizeof (DWORD) , 

&pClient, 

sizeof (PCLIENT_INFO) , 

&nBytes , NULL ) ; 

if ( rc == 0 ) { 

4 5 strncpyt ErrorMsg, "DeviceloControl with Code DP_OPEN_M0DEM 

Failed" , 

MAX_ERRORMSG_LEN ) ; 

return NULL; 

} 



return (HANDLE) pCl ient ; 
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} 

BOOL WINAPI ModemClose ( HANDLE hMociem ) 
{ 

5 if ( hModCtrlVxd = = NULL ) { 

strncpy( ErrorMsg, "Can't close modem: ModCtrl.vxd not loaded", 
MAX_ERRORMSG_LEN ) ; 

return FALSE 

} 

10 if ( hModem == NULL ) { 

strncpy( ErrorMsg, "Can't close modem: NULL handle", 
MAX_ERRORMSG_LEN ) ; 

return FALSE ; 

} 

15 

unsigned long nBytes; 

PCLIENT_INFO pClient = ( PCL I ENT__ INFO) hModem; 

BOOL rc = DeviceloControl ( hModCtrlVxd, 
2 0 DP_CLOSE_MODEM , 

&pClient , 

sizeof (PCLIENT_INFO) , 

NULL, 0 , 
&nBytes, NULL ) ; 

25 if (-rc «« 0 ) { 

strncpy( ErrorMsg, "DeviceloControl with Code DP_CLOSE_MODEM 

Failed", 

MAX_ERRORMSG_LEN ) ; 

return NULL ; 

30 . > 

return 1; 

} 

DWORD WINAPI ModemGetCodesVersiont) 
35 { 

return MODEM_CODES__VERS ION ; 

} 

BOOL WINAPI ModemConf igure (HANDLE hModem, DWORD dwConf igCode , PVOID 
4 0 plnBuffer, 

DWORD nlnBuf ferSize, PVOID pOutBuffer, DWORD 



nOutBuf f erSize , 

{ 



PDWORD pBytesRe turned ) 



4 5 BOOL rc; 

MODEM CTR L_D ATA ModemCtrlData ; 

PCLIENT^INFO pClient = ( PCLIENT_INFO) hModem ; 

DWORD Byte sRe turned ,- 
#ifdef WINDOWS_NT 
50 UPD ATE_S TRUCT UpdateClient ; 

#endif 

if ( hModem == NULL ) { 

strncpy{ ErrorMsg, "ModemConf igure failed: HANDLE is NULL", 

5 5 MAX_ERRORMSG_LEN ) ; 

32 



JSDOCID: <WO 9945695A1_L> 



WO 99/45695 PCIYUS99/04841 



return FALSE; 

} 

#ifdef WINDOW S_NT 
5 rc = DeviceloControl { hModCtrlVxd, 

DP_UPDATE_MODEM , 
SchModem, sizeof (DWORD) , 

^UpdateClient , sizeof (UPDATE_STRUCT) , 
PBytesReturned, NULL ) ; 

10 if [ rc == FALSE ) 

{ 

return FALSE; 

} 

if (( UpdateClient . Status -= DPACTIVE ) (UpdateClient . ID 1= 

15 RKID_WINAC) ) { 
#else 

if (( pClient -> Status == DPACTIVE ) && {pClient -> ID != 
RKID_WINAC) ) { 
#endif 

20 // Can't configure an active modulation, unless it is WinAC. 

strr.cpy( ErrorMsg, "Modem is active", MAX_ERRORMSG_LEN ); 
return FALSE; 

} 

25 #ifdef WINDOWS_NT 

ModemCtrlData .ObjectID = UpdateClient . ID ; 

#else 

ModemCtrlData .ObjectID - pClient -> ID; 

#endif 

30 ModemCtrlData . Codelndex = dwConf igCode ; 

ModemCtrlData .plnBuffer = plnBuffer; 

ModemCtrlData . cblnBuffer = nlnBuf f erSize ; 

ModemCtrlData .pOutBuffer = pOutBuffer; 

ModemCtrlData . cbOutBuffer = nOutBuff erSize ; 
35 ModemCtrlData .pBytesReturned = pBytesReturned; 

rc = DeviceloControl ( hModCtrlVxd, 

DP_CONFIGURE_MODEM , 
&ModemCtrlDatav 

40 sizeof (MODEMCTRL_DATA) , 

NULL, 0, 

ScBytesReturned, NULL ) ; 

if ( rc « FALSE ) 
45 strncpy( ErrorMsg, "DeviceloControl with Code 

DP_CONFIGURE_MODEM Failed", 

MAX_SRRORMSG_LEN ) ; 

return rc; 

50 } 

BOOL WINAPI ModemControl ( HANDLE hModem, DWORD dwConf igCode , PVOID 
plnBuffer, 

DWORD nlnBuf f erSize, PVOID pOutBuffer, DWORD 

55 nOutBuff erSize , 
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PDWORD pBytesReturned ) 

{ 

BOOL rc; 

PCLIENT_INFO pClient = (PCLIENT_INFO) hModem; 

5 DWORD BytesReturned; 

#ifdef WINDOWS_NT 

UPDATE_STRUCT UpdateClient ; 

Sendif 

MODEM CTRL_D ATA ModemCtrlData; 

10 

if ( pClient == NULL ) { 

strncpy( ErrorMsg, ' "ModemControl failed: HANDLE is NULL" , 
MAX_ERRORMSG_LEN ) ; 

return FALSE ; 

15 } 

#ifdef WINDOWS_NT 

rc = DeviceloControl ( hModCtrlVxd, 

DP_UPDATE_MODEM , 
fchModem, sizeof (DWORD) , 
20 &Update Client , sizeof (UPDATE_STRUCT) , 

&BytesRe turned, NULL ) ; 

if ( rc == FALSE ) 
{ 

return FALSE; 

25 } 

if ( UpdateClient .Status != DPACTIVE ) { 

#else 

if ( pClient -> Status != DPACTIVE ) { 

#endif 

30 strncpy( ErrorMsg, "modem is not active", MAX_ERRORMSG_LEN ); 

return FALSE; 

} 

. flifdef WINDOWS_NT 

3 5 ModemCtrlData. Object ID = UpdateClient . ID; 

#else 

ModemCtrlData . Object ID = pClient -> ID; 

#endif 

ModemCtrlData . Code Index = dwConf igCode ;' 

4 0 ModemCtrlData .plnBuffer plnBuffer; 

ModemCtrlData. cblnBuffer = nlnBuff erSize ,- 
ModemCtrlData . pOutBuffer = pOutBuffer; 
ModemCtrlData. cbOutBuffer = nOutBuff erSize ; 
ModemCtrlData . pBytesReturned = pBytesReturned; 

45 

rc = DeviceloControl ( hModCtrlVxd, 

DP_CONTROL_MODEM , 
^ModemCtrlData , 

sizeof (MODEMCTRL_DATA) , 
50 NULL, 0, 

PBytesReturned, NULL ) ; 

if ( rc == FALSE ) 

strncpyf ErrorMsg, "DeviceloControl with Code DP CONTROL MODEM 



55 Failed" , 
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} 



MAX_ERRORMSG_LEN ) , 

return rc; 



BOOL WINAPI ModemMonitor ( HANDLE hModem, DWORD dwConf igCode , PVOID 
plnBuffer, 

DWORD nlnBuf f erSize, PVOID pOutBuffer, DWORD 

nOutBuff erSize, 

{ 



PDWORD pBytesReturned ) 



BOOL rc ; 

PCLIENT_INFO pClient = (PCLIENT_INFO) hModem; 

MODEMCTRL_DATA ModemCt r IDa t a ; 

15 DWORD' BytesReturned; 

#ifdef WINDOWS_NT 

UPDATE_STRUCT UpdateClient; 

#endif 

20 if ( pClient == NULL ) { 

strncpy( ErrorMsg, "ModemMonitor failed: HANDLE is NULL" , 
MAX_ERRORMSG_LEN ) ; 

return FALSE; 

} 

25 

#ifdef WINDOWS_NT 

rc = Device IoControl ( hModCtr 1 Vxd , 

DP_UPDATE_MODEM , 
fichModem, sizeof (DWORD) , 
30 &Update Client , sizeof (UPDATE_STRUCT) 

PBytesReturned, NULL ) ; 

if ( rc == FALSE ) 
{ 

return FALSE; 

35 } 

if ( UpdateClient .Status != DPACTIVE ) { 

#else 

if ( pClient -> Status != DPACTIVE ) { 

#endif 

40 //strncpy( ErrorMsg, "Modem is not active", MAX_ERRORMSG_LEN ), 

return FALSE; 



4 5 #ifdef WINDOWS_NT 

ModemCtrlData. Object ID = UpdateClient . ID; 

#else 

ModemCtrlData .Object ID = pClient -> ID; 

#endif 

50 ModemCtrlData . Codelndex = dwConf igCode ; 

ModemCtrlData .plnBuffer = plnBuffer; 

ModemCtrlData . cblnBuffer = nlnBuf f erSize ; 

ModemCtrlData .pOutBuffer = pOutBuffer; 

ModemCtrlData . cbOutBuffer = nOutBuff erSize ; 
55 ModemCtrlData .pBytesReturned = pBytesReturned; 
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rc = Device loControl ( hModCtrlVxd, 

DP_M0NITOR_MODEM , 
&ModemCtrlData , 

5 sizeof (MODEMCTRL_DATA) , 

pOutBuffer, nOutBuf f erSize , 
pBytesReturned, NULL ) ; 

if ( rc == FALSE ) 

10 strncpyt ErrorMsg, "DeviceloControl with Code DP_MONITOR_MODEM 

Failed", 

MAX_ERRORMSG_LEN ) ; 

return rc; 

15 } 

VOID WINAPI ModemGctLastError ( PCHAR pBuf, DWORD nBuf ) 
{ 

strncpyt pBuf , ErrorMsg, nBuf ); 

20 } 
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CLAIMS 

1 . A communi cation system comprising: 
a modem; 

a communication channel; 

ihc modem having internal settings representing communication parameters, the 
modem being communicatively coupled to the communication channel to carry out ongoing 
communications through the communication channel; and 

a software module being remotely associated with the modem, the software module 
accessing the internal settings of the modem via the conimunication channel and performing 
diagnostics using the internal settings of the modem. 

2. The communication system of claim 1 wherein the software module further 
comprises a modem interface that interacts with the software module and assists the software 
module in performing diagnostics using the internal parameters of the modem. 

3. The communication system of claims 1 or 2 wherein the software module 
accesses the communication channel transparently to the ongoing communications between 
the modem and the communication channel when the software, module performs the 
diagnostics using the internal parameters of the modem. 

4. The communication system of claim 1 wherein the software module accesses 
the communication channel without detrimentally affecting the ongoing communications 
between the modem and the communication channel. 

5. The communication system of claims 1, 2, or 4 wherein the software module 
performs diagnostics using the internal parameters of the modem via the same 
communication channel that is used to carry out ongoing communications between the 
modem and the communication channel. 

6. The communication system of claims 1, 2, or 4 wherein the diagnostics 
performed by the software module comprise monitoring a data stream in the communication 
channel. 
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7. The communication system of claims 1, 2, or 4 wherein the diagnostics 
performed by the software module comprise configuring the internal settings of the modem 
based on information obtained regarding a data stream between the modem and the 
communication channel. 

5 8. The communication system of claims 1, 2, or 4 wherein the diagnostics 

performed by the software module comprise controlling the internal settings of the modem 
according to information obtained regarding a data stream across the communication channel. 

9. The communication system of claims 1, 2, or 4 wherein the software module 
further comprises a user interactive interface for diagnostics. 

10 10. The communication system of claims 1, 2, or 4 further comprising a plurality 

of software modules being associated, respectively, with each of a plurality of modems. 

11. The communication system of claims 1, 2, or 4 wherein the modem is 
communicatively coupled to another modem via a network. 

12. The communication system of claims 1, 2, or 4 wherein the software module is 
15 accessed through at least one remote computer system. 
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